home *** CD-ROM | disk | FTP | other *** search
/ Macworld Expo - Develope…Central & Net Innovations / Developer Central and Net Innovators (MacWorld Expo) (January 1999).iso / Developer Central / Metrowerks CodeWarrior / CodeWarrior Pro 4 Release Notes / Java Notes / StandAlone HowTo < prev    next >
Encoding:
Text File  |  1998-08-25  |  5.2 KB  |  122 lines  |  [TEXT/CWIE]
  1. ========================================================================
  2. Metrowerks Java StandAlone How To
  3. ========================================================================
  4.  
  5. Version: 1.5
  6. Date:    8-25-98
  7. Authors: Greg Bolsinga, Michael C. Stricklin, Scott Kovatch,
  8.     Marcus Jager, Tim Freehill
  9. ========================================================================
  10.  
  11. StandAlone Java is an application that hosts Java Virtual Machines on 
  12. the Macintosh. It supports Apple's MRJ 2.0 and Metrowerks' JVM. It
  13. creates double-clickable MacOS java applications.
  14.  
  15.  
  16. ========================================================================
  17. How To Use
  18. ========================================================================
  19.  
  20. Metrowerks Java StandAlone encapsulates the JVM interface with the
  21. user's java code. The JVM will be found in the usual places:
  22.  
  23. MRJ: In the default Extensions folder installation, or next to the
  24.     StandAlone MacOS application, if the user wants to use newer 
  25.     versions of MRJ.
  26.     
  27. MW JVM: The same folder as the generated StandAlone _only_.
  28.  
  29. Use the Java MacOS Post Linker and set it to MW Standalone.
  30.  
  31. If the JVM is set to 'Metrowerks' or 'Metrowerks - JIT', the file
  32. 'Metrowerks VM' & the folders 'Classes' & 'Lib' _must_ be in the same
  33. folder as the StandAlone MacOS application. If they aren't, StandAlone
  34. will look for MRJ.
  35.  
  36. The settings in for MW Standalone control whether a Console window is
  37. made available and the behavior desired when files are dropped onto
  38. the resulting StandAlone MacOS application.
  39.  
  40. The console window won't display itself until it is needed, check or
  41. uncheck "Has Console Window" to set.
  42.  
  43. The behavior of the resulting StandAlone MacOS application in relation
  44. to files dropped onto it can also be modified. In previous versions of
  45. StandAlone, every file dropped onto the StandAlone MacOS application
  46. would create a new JVM instance with the filename as an argument added
  47. to the end of the list. Now there are four options:
  48.  
  49. 1. No dropped files allowed. No files dropped onto the StandAlone MacOS
  50.    application will ever be added to the java application's argument
  51.    list. It can be started up by a dropped file, but the file is
  52.    ignored. All subsequent dropped files are ignored. This only allows
  53.    one instance of the JVM to be created during the StandAlone MacOS
  54.    application's lifetime.
  55.    
  56. 2. First dropped file only. Only the first file dropped onto the
  57.    StandAlone MacOS application will be added to the command line
  58.    arguments for the java application. If the StandAlone MacOS
  59.    application is started up without a file dropped upon it, it will
  60.    ignore any more dropped files. This only allows one instance of the
  61.    JVM to be created during the StandAlone MacOS application's lifetime.
  62.  
  63. 3. Multiple files can be dropped, one JVM. All files dropped onto the
  64.    StandAlone MacOS application will be added added the command line
  65.    arguments for a new java application instance. This allows only one
  66.    instance of the JVM to exist at one time during the StandAlone MacOS
  67.    application's lifetime. It will kill the current instance of the JVM
  68.    whenever a new file is dropped on the StandAlone MacOS application.
  69.    
  70. 4. Multiple files can be dropped, many JVMs. All files dropped onto the
  71.    StandAlone MacOS application will be added added the command line
  72.    arguments for a new java application instance. This allows many
  73.    instances of the JVM to exist at one time during the StandAlone MacOS
  74.    application's lifetime. This was the previous behavior of the 
  75.    StandAlone MacOS application.
  76.  
  77.   
  78. ========================================================================
  79. Known Bugs and Incompatibilities
  80. ========================================================================
  81.  
  82. * Either MRJ or the Metrowerks JVM may crash StandAlone Java if their
  83.   respective class libraries are not found in their proper places.
  84.  
  85.  
  86. ========================================================================
  87. Additional Notes
  88. ========================================================================
  89.  
  90. *  To use this version of StandAlone Java, the files Metrowerks Java
  91.    JVM, and the Classes and Lib folder must reside in the same folder as 
  92.    StandAlone Java. Or MRJ must be properly installed. If you'd like to
  93.    use a newer version of MRJ & keep around an old one, place an alias
  94.    to "MRJLib" next to StandAlone Java. It will find and load the MRJ in
  95.    the application's folder before any installed in the Extensions
  96.    folder.
  97.  
  98. *  The new .cab support in the MW appletviewer (only in the MW JVM) now
  99.    creates a folder called "Retrieved Files" in the same folder as the
  100.    application. This folder is used to store temporary files for the cab
  101.    decompression engine.
  102.  
  103.  
  104. ========================================================================
  105. Contacting Metrowerks
  106. ========================================================================
  107.  
  108. For bug reports, technical questions, and suggestions, please use the
  109. forms in the Release Notes folder on the CD, and send them to
  110.  
  111. support@metrowerks.com
  112.  
  113. See the CodeWarrior on the Nets document in the Release Notes folder for
  114. more contact information, including a list of Internet newsgroups, 
  115. online services, and patch and update sites.
  116.  
  117.  
  118. ========================================================================
  119.  
  120. Greg Bolsinga
  121. Metrowerks Corporation
  122.